Compares two Pascal strings for equality, making use of the string comparison information from a resource that you specify as a parameter.

SInt16 IdenticalString (
    ConstStr255Param aStr, 
    ConstStr255Param bStr, 
    Handle itl2Handle
);

Parameter descriptions

aStr

One of the Pascal strings to be compared.

bStr

The other Pascal string to be compared.

itl2Handle

A handle to a string-manipulation ('itl2') resource that contains string comparison information.

The itl2Handle parameter is used to specify a string-manipulation resource. If the value of this parameter is NULL, IdenticalString makes use of the resource for the current script. The string-manipulation resource includes tables for modifying string comparison and tables for case conversion and stripping of diacritical marks.

function result

Returns 0 if the two strings are equal; 1 if they are not equal. It compares the two strings without regard for secondary sorting order, the meaning of which depends on the language of the strings. For example, for the English language, using only primary differences means that IdenticalString ignores diacritical marks and does not distinguish between lowercase and uppercase. For example, if the two strings are 'Rose' and 'rosé', IdenticalString considers them equal and returns 0.

DISCUSSION

IdenticalString uses only primary differences in its comparison.

SPECIAL CONSIDERATIONS

IdenticalString may move memory; your application should not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)